<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>lut_trans [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_filters.html">过滤器</a> / <a href="toc_filters_misc.html">Misc</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">lut_trans</span><span data-if="c" style="display:none;">T_lut_trans</span><span data-if="cpp" style="display:none;">LutTrans</span><span data-if="dotnet" style="display:none;">LutTrans</span><span data-if="python" style="display:none;">lut_trans</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">lut_trans</span><span data-if="c" style="display:none;">T_lut_trans</span><span data-if="cpp" style="display:none;">LutTrans</span><span data-if="dotnet" style="display:none;">LutTrans</span><span data-if="python" style="display:none;">lut_trans</span></code> — Transform an image with a gray-value look-up-table</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>lut_trans</b>(<a href="#Image"><i>Image</i></a> : <a href="#ImageResult"><i>ImageResult</i></a> : <a href="#Lut"><i>Lut</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_lut_trans</b>(const Hobject <a href="#Image"><i>Image</i></a>, Hobject* <a href="#ImageResult"><i>ImageResult</i></a>, const Htuple <a href="#Lut"><i>Lut</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>LutTrans</b>(const HObject&amp; <a href="#Image"><i>Image</i></a>, HObject* <a href="#ImageResult"><i>ImageResult</i></a>, const HTuple&amp; <a href="#Lut"><i>Lut</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>LutTrans</b>(const HTuple&amp; <a href="#Lut"><i>Lut</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>LutTrans</b>(<a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, out <a href="HObject.html">HObject</a> <a href="#ImageResult"><i>imageResult</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Lut"><i>lut</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>.<b>LutTrans</b>(<a href="HTuple.html">HTuple</a> <a href="#Lut"><i>lut</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>lut_trans</b>(<a href="#Image"><i>image</i></a>: HObject, <a href="#Lut"><i>lut</i></a>: Sequence[int]) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">lut_trans</span><span data-if="c" style="display:none">lut_trans</span><span data-if="cpp" style="display:none">LutTrans</span><span data-if="com" style="display:none">LutTrans</span><span data-if="dotnet" style="display:none">LutTrans</span><span data-if="python" style="display:none">lut_trans</span></code> transforms an image <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a> by using a gray
value look-up-table <a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a>.  This table acts as a
transformation function. In the case of byte-images, <a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a>
has to be a tuple of length 256.  In the case of int2-images,
<a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a> has to be a tuple of length 256 &lt;= length &lt;= 65536.  If
the length of the <a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a> is &lt;= 32768, the transformation is
applied to the positive gray values only, i.e., the first element of
the <a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a> specifies the new gray value for the gray value 0.
If the <a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a> is longer than 32768, exactly 65536 must be
passed.  In this case, the positive and negative gray values are
transformed.  In this case, the first element indicates the new gray
value for the gray value -32768 of the input image, while the last
element of the tuple indicates the new gray value for the gray value
32767.  In all cases, the gray values of values outside the range of
<a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a> are set to 0.  In the case of uint2-images,
<a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a> has to be a tuple of length 256 &lt;= length &lt;=
65536. Gray values outside the range of <a href="#Lut"><i><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></i></a> are set to 0.</p>
<h2 id="sec_attention">注意</h2>
<p><code><span data-if="hdevelop" style="display:inline">lut_trans</span><span data-if="c" style="display:none">lut_trans</span><span data-if="cpp" style="display:none">LutTrans</span><span data-if="com" style="display:none">LutTrans</span><span data-if="dotnet" style="display:none">LutTrans</span><span data-if="python" style="display:none">lut_trans</span></code> can be executed on OpenCL devices.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
    
      <li>支持OpenCL计算设备。</li>
    
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
    <li>在图像通道级别自动并行化。</li>
    <li>Automatically parallelized on  domain level.</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte* / int2* / uint2*)<i> *allowed for compute devices</i></span>
</div>
<p class="pardesc">Image whose gray values are to be transformed.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageResult" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageResult</span><span data-if="c" style="display:none">ImageResult</span><span data-if="cpp" style="display:none">ImageResult</span><span data-if="com" style="display:none">ImageResult</span><span data-if="dotnet" style="display:none">imageResult</span><span data-if="python" style="display:none">image_result</span></code></b> (output_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (byte / int2 / uint2)</span>
</div>
<p class="pardesc">Transformed image.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Lut" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Lut</span><span data-if="c" style="display:none">Lut</span><span data-if="cpp" style="display:none">Lut</span><span data-if="com" style="display:none">Lut</span><span data-if="dotnet" style="display:none">lut</span><span data-if="python" style="display:none">lut</span></code></b> (input_control)  </span><span>integer-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Table containing the transformation.</p>
</div>
<h2 id="sec_example_all">例程 (HDevelop)</h2>
<pre class="example">
* Apply a gamma correction to an image.
Gamma := 2.2
GammaLUT := []
for G := 0 to 255 by 1
    GammaLUT := [GammaLUT,round(255.0*pow(G/255.0,1.0/Gamma))]
endfor
read_image (Image, 'mreut')
lut_trans (Image, ImageGamma, GammaLUT)
</pre>
<h2 id="sec_result">结果</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">lut_trans</span><span data-if="c" style="display:none">lut_trans</span><span data-if="cpp" style="display:none">LutTrans</span><span data-if="com" style="display:none">LutTrans</span><span data-if="dotnet" style="display:none">LutTrans</span><span data-if="python" style="display:none">lut_trans</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if the
parameters are correct.  Otherwise an exception is raised.</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
